IRIX Base Documentation 2002 November/SGI IRIX Base Documentation 2002 November.iso/usr/share/catman/g_man/cat3/OpenGL/glxchoosefbconfigsgix.z/glxchoosefbconfigsgix

Text File | 2002-10-03 | 45.0 KB | 595 lines

ggggllllXXXXCCCChhhhoooooooosssseeeeFFFFBBBBCCCCoooonnnnffffiiiiggggSSSSGGGGIIIIXXXX((((3333GGGG))))   OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee ---- GGGGLLLLXXXX   ggggllllXXXXCCCChhhhoooooooosssseeeeFFFFBBBBCCCCoooonnnnffffiiiiggggSSSSGGGGIIIIXXXX((((3333GGGG))))



NNNNAAAAMMMMEEEE
     ggggllllXXXXCCCChhhhoooooooosssseeeeFFFFBBBBCCCCoooonnnnffffiiiiggggSSSSGGGGIIIIXXXX - return a list of GLX frame buffer configurations
     that match the specified attributes


CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
     GLXFBConfigSGIX * ggggllllXXXXCCCChhhhoooooooosssseeeeFFFFBBBBCCCCoooonnnnffffiiiiggggSSSSGGGGIIIIXXXX( Display *_d_p_y,
                                              int _s_c_r_e_e_n,
                                              int *_a_t_t_r_i_b__l_i_s_t,
                                              int *_n_i_t_e_m_s )


PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
     _d_p_y          Specifies the connection to the X server.


     _s_c_r_e_e_n       Specifies the screen number.


     _a_t_t_r_i_b__l_i_s_t  Specifies a list of attribute/value pairs.  The last
                  attribute must be NNNNoooonnnneeee.


     _n_i_t_e_m_s       Returns the number of elements in the list returned by
                  ggggllllXXXXCCCChhhhoooooooosssseeeeFFFFBBBBCCCCoooonnnnffffiiiiggggSSSSGGGGIIIIXXXX.


DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
     If _a_t_t_r_i_b__l_i_s_t is NNNNUUUULLLLLLLL then ggggllllXXXXCCCChhhhoooooooosssseeeeFFFFBBBBCCCCoooonnnnffffiiiiggggSSSSGGGGIIIIXXXX returns an array of GLX
     frame buffer configurations that are available on the specified screen;
     otherwise ggggllllXXXXCCCChhhhoooooooosssseeeeFFFFBBBBCCCCoooonnnnffffiiiiggggSSSSGGGGIIIIXXXX returns an array of GLX frame buffer
     configurations that match the specified attributes. If an error occurs,
     no frame buffer configurations exist on the specified screen, or if no
     frame buffer configurations match the specified attributes, then NNNNUUUULLLLLLLL is
     returned.  Use XXXXFFFFrrrreeeeeeee to free the memory returned by
     ggggllllXXXXCCCChhhhoooooooosssseeeeFFFFBBBBCCCCoooonnnnffffiiiiggggSSSSGGGGIIIIXXXX.

     All attributes in _a_t_t_r_i_b__l_i_s_t, including boolean attributes, are
     immediately followed by the corresponding desired value. The list is
     terminated with NNNNoooonnnneeee. If an attribute is not specified in _a_t_t_r_i_b__l_i_s_t
     then the default value (see below) is used (and the attribute is said to
     be specified implicitly). For example, if GGGGLLLLXXXX____SSSSTTTTEEEERRRREEEEOOOO is not specified
     then it is assumed to be FFFFaaaallllsssseeee. For some attributes, the default is
     "don't care" meaning that any value is OK for this attribute, so the
     attribute will not be checked.

     Attributes are matched in an attribute-specific manner.  Some of the
     attributes, such as GGGGLLLLXXXX____LLLLEEEEVVVVEEEELLLL, must match the specified value exactly;
     others, such as, GGGGLLLLXXXX____RRRREEEEDDDD____SSSSIIIIZZZZEEEE must meet or exceed the specified minimum
     values. If more than one GLX frame buffer configuration is found, then a
     list of configurations, sorted according to the "best" match criteria, is
     returned. The match criteria for each attribute and the exact sorting



                                                                        PPPPaaaaggggeeee 1111






ggggllllXXXXCCCChhhhoooooooosssseeeeFFFFBBBBCCCCoooonnnnffffiiiiggggSSSSGGGGIIIIXXXX((((3333GGGG))))   OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee ---- GGGGLLLLXXXX   ggggllllXXXXCCCChhhhoooooooosssseeeeFFFFBBBBCCCCoooonnnnffffiiiiggggSSSSGGGGIIIIXXXX((((3333GGGG))))



     order is defined below.

     The interpretations of the various GLX visual attributes are as follows:

     GGGGLLLLXXXX____BBBBUUUUFFFFFFFFEEEERRRR____SSSSIIIIZZZZEEEE          Must be followed by a nonnegative integer that
                              indicates the desired color index buffer size.
                              The smallest index buffer of at least the
                              specified size is preferred.  Ignored if
                              GGGGLLLLXXXX____CCCCOOOOLLLLOOOORRRR____IIIINNNNDDDDEEEEXXXX____BBBBIIIITTTT____SSSSGGGGIIIIXXXX is not set in
                              GGGGLLLLXXXX____RRRREEEENNNNDDDDEEEERRRR____TTTTYYYYPPPPEEEE____SSSSGGGGIIIIXXXX. The default value is 0.

     GGGGLLLLXXXX____LLLLEEEEVVVVEEEELLLL                Must be followed by an integer buffer-level
                              specification.  This specification is honored
                              exactly.  Buffer level zero corresponds to the
                              default frame buffer of the display.  Buffer
                              level one is the first overlay frame buffer,
                              level two the second overlay frame buffer, and
                              so on.  Negative buffer levels correspond to
                              underlay frame buffers.  The default value is 0.

     GGGGLLLLXXXX____DDDDOOOOUUUUBBBBLLLLEEEEBBBBUUUUFFFFFFFFEEEERRRR         Must be followed by TTTTrrrruuuueeee or FFFFaaaallllsssseeee. If TTTTrrrruuuueeee is
                              specified then only double-buffered frame buffer
                              configurations are considered; if FFFFaaaallllsssseeee is
                              specified then only single-buffered frame buffer
                              configurations are considered.  The default
                              value is "don't care".

     GGGGLLLLXXXX____SSSSTTTTEEEERRRREEEEOOOO               Must be followed by TTTTrrrruuuueeee or FFFFaaaallllsssseeee. If TTTTrrrruuuueeee is
                              specified then only stereo frame buffer
                              configurations are considered; if FFFFaaaallllsssseeee is
                              specified then only monoscopic frame buffer
                              configurations are considered.  The default
                              value is FFFFaaaallllsssseeee.

     GGGGLLLLXXXX____AAAAUUUUXXXX____BBBBUUUUFFFFFFFFEEEERRRRSSSS          Must be followed by a nonnegative integer that
                              indicates the desired number of auxiliary
                              buffers.  Configurations with the smallest
                              number of auxiliary buffers that meet or exceed
                              the specified number are preferred.  The default
                              value is 0.

     GGGGLLLLXXXX____RRRREEEEDDDD____SSSSIIIIZZZZEEEE             Must be followed by a nonnegative minimum size
                              specification.  If this value is zero, the
                              smallest available red buffer is preferred.
                              Otherwise, the largest available red buffer of
                              at least the minimum size is preferred.  The
                              default value is 0.

     GGGGLLLLXXXX____GGGGRRRREEEEEEEENNNN____SSSSIIIIZZZZEEEE           Must be followed by a nonnegative minimum size
                              specification.  If this value is zero, the
                              smallest available green buffer is preferred.
                              Otherwise, the largest available green buffer of



                                                                        PPPPaaaaggggeeee 2222






ggggllllXXXXCCCChhhhoooooooosssseeeeFFFFBBBBCCCCoooonnnnffffiiiiggggSSSSGGGGIIIIXXXX((((3333GGGG))))   OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee ---- GGGGLLLLXXXX   ggggllllXXXXCCCChhhhoooooooosssseeeeFFFFBBBBCCCCoooonnnnffffiiiiggggSSSSGGGGIIIIXXXX((((3333GGGG))))



                              at least the minimum size is preferred.  The
                              default value is 0.

     GGGGLLLLXXXX____BBBBLLLLUUUUEEEE____SSSSIIIIZZZZEEEE            Must be followed by a nonnegative minimum size
                              specification.  If this value is zero, the
                              smallest available blue buffer is preferred.
                              Otherwise, the largest available blue buffer of
                              at least the minimum size is preferred.  The
                              default value is 0.

     GGGGLLLLXXXX____AAAALLLLPPPPHHHHAAAA____SSSSIIIIZZZZEEEE           Must be followed by a nonnegative minimum size
                              specification.  If this value is zero, the
                              smallest available alpha buffer is preferred.
                              Otherwise, the largest available alpha buffer of
                              at least the minimum size is preferred.  The
                              default value is 0.

     GGGGLLLLXXXX____DDDDEEEEPPPPTTTTHHHH____SSSSIIIIZZZZEEEE           Must be followed by a nonnegative minimum size
                              specification.  If this value is zero, frame
                              buffer configurations with no depth buffer are
                              preferred.  Otherwise, the largest available
                              depth buffer of at least the minimum size is
                              preferred.  The default value is 0.

     GGGGLLLLXXXX____SSSSTTTTEEEENNNNCCCCIIIILLLL____SSSSIIIIZZZZEEEE         Must be followed by a nonnegative integer that
                              indicates the desired number of stencil
                              bitplanes.  The smallest stencil buffer of at
                              least the specified size is preferred.  If the
                              desired value is zero, frame buffer
                              configurations with no stencil buffer are
                              preferred.  The default value is 0.

     GGGGLLLLXXXX____AAAACCCCCCCCUUUUMMMM____RRRREEEEDDDD____SSSSIIIIZZZZEEEE       Must be followed by a nonnegative minimum size
                              specification.  If this value is zero, frame
                              buffer configurations with no red accumulation
                              buffer are preferred.  Otherwise, the largest
                              possible red accumulation buffer of at least the
                              minimum size is preferred.  The default value is
                              0.

     GGGGLLLLXXXX____AAAACCCCCCCCUUUUMMMM____GGGGRRRREEEEEEEENNNN____SSSSIIIIZZZZEEEE     Must be followed by a nonnegative minimum size
                              specification.  If this value is zero, frame
                              buffer configurations with no green accumulation
                              buffer are preferred.  Otherwise, the largest
                              possible green accumulation buffer of at least
                              the minimum size is preferred.  The default
                              value is 0.

     GGGGLLLLXXXX____AAAACCCCCCCCUUUUMMMM____BBBBLLLLUUUUEEEE____SSSSIIIIZZZZEEEE      Must be followed by a nonnegative minimum size
                              specification.  If this value is zero, frame
                              buffer configurations with no blue accumulation
                              buffer are preferred.  Otherwise, the largest



                                                                        PPPPaaaaggggeeee 3333






ggggllllXXXXCCCChhhhoooooooosssseeeeFFFFBBBBCCCCoooonnnnffffiiiiggggSSSSGGGGIIIIXXXX((((3333GGGG))))   OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee ---- GGGGLLLLXXXX   ggggllllXXXXCCCChhhhoooooooosssseeeeFFFFBBBBCCCCoooonnnnffffiiiiggggSSSSGGGGIIIIXXXX((((3333GGGG))))



                              possible blue accumulation buffer of at least
                              the minimum size is preferred.  The default
                              value is 0.

     GGGGLLLLXXXX____AAAACCCCCCCCUUUUMMMM____AAAALLLLPPPPHHHHAAAA____SSSSIIIIZZZZEEEE     Must be followed by a nonnegative minimum size
                              specification.  If this value is zero, frame
                              buffer configurations with no alpha accumulation
                              buffer are preferred.  Otherwise, the largest
                              possible alpha accumulation buffer of at least
                              the minimum size is preferred.  The default
                              value is 0.

     GGGGLLLLXXXX____SSSSAAAAMMMMPPPPLLLLEEEE____BBBBUUUUFFFFFFFFEEEERRRRSSSS____SSSSGGGGIIIISSSS  Must be followed by the minimum acceptable
                              number of multisample buffers.  Configurations
                              with the smallest number of multisample buffers
                              that meet or exceed this minimum number are
                              preferred.  Currently operation with more than
                              one multisample buffer is undefined, so only
                              values of zero or one will produce a match.  The
                              default value is 0.

     GGGGLLLLXXXX____SSSSAAAAMMMMPPPPLLLLEEEESSSS____SSSSGGGGIIIISSSS         Must be followed by the minimum number of
                              samples required in multisample buffers.
                              Configurations with the smallest number of
                              samples that meet or exceed the specified
                              minimum number are preferred.  Note that it is
                              possible for color samples in the multisample
                              buffer to have fewer bits than colors in the
                              main color buffers.  However, multisampled
                              colors maintain at least as much color
                              resolution in aggregate as the main color
                              buffers.

                              The default value is 0.

     GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____TTTTYYYYPPPPEEEE____EEEEXXXXTTTT Must be followed by one of GGGGLLLLXXXX____NNNNOOOONNNNEEEE____EEEEXXXXTTTT,
                              GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____RRRRGGGGBBBB____EEEEXXXXTTTT,
                              GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____IIIINNNNDDDDEEEEXXXX____EEEEXXXXTTTT.  If GGGGLLLLXXXX____NNNNOOOONNNNEEEE____EEEEXXXXTTTT is
                              specified, then only opaque frame buffer
                              configurations will be considered; if
                              GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____RRRRGGGGBBBB____EEEEXXXXTTTT is specified, then only
                              transparent frame buffer configurations that
                              support RGBA rendering will be considered; if
                              GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____IIIINNNNDDDDEEEEXXXX____EEEEXXXXTTTT is specified, then
                              only transparent frame buffer configurations
                              that support color index rendering will be
                              considered.  The default value is GGGGLLLLXXXX____NNNNOOOONNNNEEEE____EEEEXXXXTTTT.

     GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____IIIINNNNDDDDEEEEXXXX____VVVVAAAALLLLUUUUEEEE____EEEEXXXXTTTT
                              Must be followed by an integer value indicating
                              the transparent index value; the value must be
                              between 0 and the maximum framebuffer value for



                                                                        PPPPaaaaggggeeee 4444






ggggllllXXXXCCCChhhhoooooooosssseeeeFFFFBBBBCCCCoooonnnnffffiiiiggggSSSSGGGGIIIIXXXX((((3333GGGG))))   OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee ---- GGGGLLLLXXXX   ggggllllXXXXCCCChhhhoooooooosssseeeeFFFFBBBBCCCCoooonnnnffffiiiiggggSSSSGGGGIIIIXXXX((((3333GGGG))))



                              indices.  Only frame buffer configurations that
                              use the specified transparent index value will
                              be considered.  The default value is "don't
                              care".

                              This attribute is ignored unless
                              GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____TTTTYYYYPPPPEEEE____EEEEXXXXTTTT is included in
                              _a_t_t_r_i_b__l_i_s_t and specified as
                              GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____IIIINNNNDDDDEEEEXXXX____EEEEXXXXTTTT.

     GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____RRRREEEEDDDD____VVVVAAAALLLLUUUUEEEE____EEEEXXXXTTTT
                              Must be followed by an integer value indicating
                              the transparent red value; the value must be
                              between 0 and the maximum framebuffer value for
                              red.  Only frame buffer configurations that use
                              the specified transparent red value will be
                              considered.  The default value is "don't care".

                              This attribute is ignored unless
                              GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____TTTTYYYYPPPPEEEE____EEEEXXXXTTTT is included in
                              _a_t_t_r_i_b__l_i_s_t and specified as
                              GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____RRRRGGGGBBBB____EEEEXXXXTTTT.

     GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____GGGGRRRREEEEEEEENNNN____VVVVAAAALLLLUUUUEEEE____EEEEXXXXTTTT
                              Must be followed by an integer value indicating
                              the transparent green value; the value must be
                              between 0 and the maximum framebuffer value for
                              green.  Only frame buffer configurations that
                              use the specified transparent green value will
                              be considered.  The default value is "don't
                              care".

                              This attribute is ignored unless
                              GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____TTTTYYYYPPPPEEEE____EEEEXXXXTTTT is included in
                              _a_t_t_r_i_b__l_i_s_t and specified as
                              GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____RRRRGGGGBBBB____EEEEXXXXTTTT.

     GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____BBBBLLLLUUUUEEEE____VVVVAAAALLLLUUUUEEEE____EEEEXXXXTTTT
                              Must be followed by an integer value indicating
                              the transparent blue value; the value must be
                              between 0 and the maximum framebuffer value for
                              blue.  Only frame buffer configurations that use
                              the specified transparent blue value will be
                              considered.  The default value is "don't care".

                              This attribute is ignored unless
                              GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____TTTTYYYYPPPPEEEE____EEEEXXXXTTTT is included in
                              _a_t_t_r_i_b__l_i_s_t and specified as
                              GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____RRRRGGGGBBBB____EEEEXXXXTTTT.






                                                                        PPPPaaaaggggeeee 5555






ggggllllXXXXCCCChhhhoooooooosssseeeeFFFFBBBBCCCCoooonnnnffffiiiiggggSSSSGGGGIIIIXXXX((((3333GGGG))))   OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee ---- GGGGLLLLXXXX   ggggllllXXXXCCCChhhhoooooooosssseeeeFFFFBBBBCCCCoooonnnnffffiiiiggggSSSSGGGGIIIIXXXX((((3333GGGG))))



     GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____AAAALLLLPPPPHHHHAAAA____VVVVAAAALLLLUUUUEEEE____EEEEXXXXTTTT
                              Must be followed by an integer value.  This
                              attribute is always ignored; it is for future
                              use only.

     GGGGLLLLXXXX____VVVVIIIISSSSUUUUAAAALLLL____CCCCAAAAVVVVEEEEAAAATTTT____EEEEXXXXTTTT    Must be followed by one of GGGGLLLLXXXX____NNNNOOOONNNNEEEE____EEEEXXXXTTTT,
                              GGGGLLLLXXXX____SSSSLLLLOOOOWWWW____VVVVIIIISSSSUUUUAAAALLLL____EEEEXXXXTTTT, GGGGLLLLXXXX____NNNNOOOONNNN____CCCCOOOONNNNFFFFOOOORRRRMMMMAAAANNNNTTTT____EEEEXXXXTTTT.  If
                              GGGGLLLLXXXX____NNNNOOOONNNNEEEE____EEEEXXXXTTTT is specified, then only frame
                              buffer configurations with no caveats will be
                              considered; if GGGGLLLLXXXX____SSSSLLLLOOOOWWWW____VVVVIIIISSSSUUUUAAAALLLL____EEEEXXXXTTTT, is specified
                              then only slow frame buffer configurations will
                              be considered; if GGGGLLLLXXXX____NNNNOOOONNNN____CCCCOOOONNNNFFFFOOOORRRRMMMMAAAANNNNTTTT____EEEEXXXXTTTT is
                              specified then only non-conformant frame buffer
                              configurations will be considered.  The default
                              value is "don't care".

     GGGGLLLLXXXX____DDDDRRRRAAAAWWWWAAAABBBBLLLLEEEE____TTTTYYYYPPPPEEEE____SSSSGGGGIIIIXXXX   Must be followed by a mask indicating which GLX
                              drawable types the frame buffer configuration
                              must support. Valid bits are
                              GGGGLLLLXXXX____WWWWIIIINNNNDDDDOOOOWWWW____BBBBIIIITTTT____SSSSGGGGIIIIXXXX, GGGGLLLLXXXX____PPPPIIIIXXXXMMMMAAAAPPPP____BBBBIIIITTTT____SSSSGGGGIIIIXXXX and
                              GGGGLLLLXXXX____PPPPBBBBUUUUFFFFFFFFEEEERRRR____BBBBIIIITTTT____SSSSGGGGIIIIXXXX.  For example, if mask is
                              set to GGGGLLLLXXXX____WWWWIIIINNNNDDDDOOOOWWWW____BBBBIIIITTTT____SSSSGGGGIIIIXXXX |
                              GGGGLLLLXXXX____PPPPIIIIXXXXMMMMAAAAPPPP____BBBBIIIITTTT____SSSSGGGGIIIIXXXX, only frame buffer
                              configurations that support both windows and GLX
                              pixmaps will be considered.  The default value
                              is GGGGLLLLXXXX____WWWWIIIINNNNDDDDOOOOWWWW____BBBBIIIITTTT____SSSSGGGGIIIIXXXX.

     GGGGLLLLXXXX____RRRREEEENNNNDDDDEEEERRRR____TTTTYYYYPPPPEEEE____SSSSGGGGIIIIXXXX     Must be followed by a mask indicating which
                              OpenGL rendering modes the frame buffer
                              configuration must support.  Valid bits are
                              GGGGLLLLXXXX____RRRRGGGGBBBBAAAA____BBBBIIIITTTT____SSSSGGGGIIIIXXXX and GGGGLLLLXXXX____CCCCOOOOLLLLOOOORRRR____IIIINNNNDDDDEEEEXXXX____BBBBIIIITTTT____SSSSGGGGIIIIXXXX.
                              If the mask is set to GGGGLLLLXXXX____RRRRGGGGBBBBAAAA____BBBBIIIITTTT____SSSSGGGGIIIIXXXX |
                              GGGGLLLLXXXX____CCCCOOOOLLLLOOOORRRR____IIIINNNNDDDDEEEEXXXX____BBBBIIIITTTT____SSSSGGGGIIIIXXXX then only frame buffer
                              configurations that can be bound to both RGBA
                              contexts and color index contexts will be
                              considered.  The default value is
                              GGGGLLLLXXXX____RRRRGGGGBBBBAAAA____BBBBIIIITTTT____SSSSGGGGIIIIXXXX.

     GGGGLLLLXXXX____XXXX____VVVVIIIISSSSUUUUAAAALLLL____TTTTYYYYPPPPEEEE____EEEEXXXXTTTT    Must be followed by one of GGGGLLLLXXXX____TTTTRRRRUUUUEEEE____CCCCOOOOLLLLOOOORRRR____EEEEXXXXTTTT,
                              GGGGLLLLXXXX____DDDDIIIIRRRREEEECCCCTTTT____CCCCOOOOLLLLOOOORRRR____EEEEXXXXTTTT, GGGGLLLLXXXX____PPPPSSSSEEEEUUUUDDDDOOOO____CCCCOOOOLLLLOOOORRRR____EEEEXXXXTTTT,
                              GGGGLLLLXXXX____SSSSTTTTAAAATTTTIIIICCCC____CCCCOOOOLLLLOOOORRRR____EEEEXXXXTTTT, GGGGLLLLXXXX____GGGGRRRRAAAAYYYY____SSSSCCCCAAAALLLLEEEE____EEEEXXXXTTTT,
                              GGGGLLLLXXXX____SSSSTTTTAAAATTTTIIIICCCC____GGGGRRRRAAAAYYYY____EEEEXXXXTTTT, indicating the desired X
                              visual type.  Not all frame buffer
                              configurations have an associated X visual. If
                              GGGGLLLLXXXX____DDDDRRRRAAAAWWWWAAAABBBBLLLLEEEE____TTTTYYYYPPPPEEEE____SSSSGGGGIIIIXXXX is specified in
                              _a_t_t_r_i_b__l_i_s_t and the mask that follows does not
                              have GGGGLLLLXXXX____WWWWIIIINNNNDDDDOOOOWWWW____BBBBIIIITTTT____SSSSGGGGIIIIXXXX set, then this value is
                              ignored. It is also ignored if
                              GGGGLLLLXXXX____XXXX____RRRREEEENNNNDDDDEEEERRRRAAAABBBBLLLLEEEE____SSSSGGGGIIIIXXXX is specified as FFFFaaaallllsssseeee.

                              RGBA rendering may be supported for visuals of
                              type GGGGLLLLXXXX____TTTTRRRRUUUUEEEE____CCCCOOOOLLLLOOOORRRR____EEEEXXXXTTTT, GGGGLLLLXXXX____DDDDIIIIRRRREEEECCCCTTTT____CCCCOOOOLLLLOOOORRRR____EEEEXXXXTTTT,



                                                                        PPPPaaaaggggeeee 6666






ggggllllXXXXCCCChhhhoooooooosssseeeeFFFFBBBBCCCCoooonnnnffffiiiiggggSSSSGGGGIIIIXXXX((((3333GGGG))))   OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee ---- GGGGLLLLXXXX   ggggllllXXXXCCCChhhhoooooooosssseeeeFFFFBBBBCCCCoooonnnnffffiiiiggggSSSSGGGGIIIIXXXX((((3333GGGG))))



                              GGGGLLLLXXXX____PPPPSSSSEEEEUUUUDDDDOOOO____CCCCOOOOLLLLOOOORRRR____EEEEXXXXTTTT, or GGGGLLLLXXXX____SSSSTTTTAAAATTTTIIIICCCC____CCCCOOOOLLLLOOOORRRR____EEEEXXXXTTTT,
                              but color index rendering is only supported for
                              visuals of type GGGGLLLLXXXX____PPPPSSSSEEEEUUUUDDDDOOOO____CCCCOOOOLLLLOOOORRRR____EEEEXXXXTTTT or
                              GGGGLLLLXXXX____SSSSTTTTAAAATTTTIIIICCCC____CCCCOOOOLLLLOOOORRRR____EEEEXXXXTTTT (i.e., single-channel
                              visuals).

                              The tokens GGGGLLLLXXXX____GGGGRRRRAAAAYYYY____SSSSCCCCAAAALLLLEEEE____EEEEXXXXTTTT and
                              GGGGLLLLXXXX____SSSSTTTTAAAATTTTIIIICCCC____GGGGRRRRAAAAYYYY____EEEEXXXXTTTT will not match current
                              OpenGL enabled visuals, but are included for
                              future use.

                              The default value for GGGGLLLLXXXX____XXXX____VVVVIIIISSSSUUUUAAAALLLL____TTTTYYYYPPPPEEEE____EEEEXXXXTTTT is
                              "don't care".

     GGGGLLLLXXXX____XXXX____RRRREEEENNNNDDDDEEEERRRRAAAABBBBLLLLEEEE____SSSSGGGGIIIIXXXX    Must be followed by TTTTrrrruuuueeee or FFFFaaaallllsssseeee.  If TTTTrrrruuuueeee is
                              specified, then only frame buffer configurations
                              that have associated X visuals (and can be used
                              to render to Windows and/or GLX pixmaps) will be
                              considered.  The default value is "don't care".

     GGGGLLLLXXXX____FFFFBBBBCCCCOOOONNNNFFFFIIIIGGGG____IIIIDDDD____SSSSGGGGIIIIXXXX     Must be followed by an XID for a GLXFBConfig.
                              When GGGGLLLLXXXX____FFFFBBBBCCCCOOOONNNNFFFFIIIIGGGG____IIIIDDDD____SSSSGGGGIIIIXXXX is specified in
                              _a_t_t_r_i_b__l_i_s_t, all other attributes are ignored,
                              and only the frame buffer configuration with the
                              given XID is returned. NNNNUUUULLLLLLLL is returned if the
                              frame buffer configuration does not exist.  The
                              default value for GGGGLLLLXXXX____FFFFBBBBCCCCOOOONNNNFFFFIIIIGGGG____IIIIDDDD____SSSSGGGGIIIIXXXX is "don't
                              care".

     When more than one GLX frame buffer configuration matches the specified
     attributes, a list of matching configurations is returned. The list is
     sorted according to the following precedence rules that are applied in
     ascending order (i.e., configurations that are considered equal by lower
     numbered rule are sorted by the higher numbered rule):
     1.  by GLX_VISUAL_RATING_EXT where the precedence is GLX_NONE_EXT,
         GLX_NON_CONFORMANT, GLX_SLOW_VISUAL.
     2.  larger total number of RGBA color components (GLX_RED_BITS,
         GLX_GREEN_BITS, GLX_BLUE_BITS, and GLX_ALPHA_BITS) that have higher
         number of bits,
     3.  smaller GLX_INDEX_BITS,
     4.  single buffered configuration (GLX_DOUBLE_BUFFER being False)
         precedes a double buffered one,
     5.  smaller GLX_AUX_BUFFERS,
     6.  smaller GLX_SAMPLE_BUFFERS_SGIS,
     7.  smaller GLX_SAMPLES_SGIS,
     8.  larger GLX_DEPTH_BITS,
     9.  smaller GLX_STENCIL_BITS,
     10. larger total number of accumulation buffer color components
         (GLX_ACCUM_RED_BITS, GLX_ACCUM_GREEN_BITS, GLX_ACCUM_BLUE_BITS, and
         GLX_ACCUM_ALPHA_BITS) that have higher number of bits;
     11. sort by GLX_VISUAL_TYPE_EXT where the precedence order is
         GLX_TRUE_COLOR_EXT, GLX_DIRECT_COLOR_EXT, GLX_PSEUDO_COLOR_EXT,



                                                                        PPPPaaaaggggeeee 7777






ggggllllXXXXCCCChhhhoooooooosssseeeeFFFFBBBBCCCCoooonnnnffffiiiiggggSSSSGGGGIIIIXXXX((((3333GGGG))))   OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee ---- GGGGLLLLXXXX   ggggllllXXXXCCCChhhhoooooooosssseeeeFFFFBBBBCCCCoooonnnnffffiiiiggggSSSSGGGGIIIIXXXX((((3333GGGG))))



         GLX_STATIC_COLOR_EXT, GLX_GRAY_SCALE_EXT, GLX_STATIC_GRAY_EXT,


EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
     _a_t_t_r_i_b__l_i_s_t =
                 {GGGGLLLLXXXX____RRRREEEENNNNDDDDEEEERRRR____TTTTYYYYPPPPEEEE____SSSSGGGGIIIIXXXX, GGGGLLLLXXXX____RRRRGGGGBBBBAAAA____BBBBIIIITTTT____SSSSGGGGIIIIXXXX, GGGGLLLLXXXX____RRRREEEEDDDD____SSSSIIIIZZZZEEEE, 4,
                 GGGGLLLLXXXX____GGGGRRRREEEEEEEENNNN____SSSSIIIIZZZZEEEE, 4, GGGGLLLLXXXX____BBBBLLLLUUUUEEEE____SSSSIIIIZZZZEEEE, 4, NNNNoooonnnneeee};

     Specifies a frame buffer configuration that supports RGBA rendering and
     exists in the normal frame buffer, not an overlay or underlay buffer.
     The returned visual supports at least four bits each of red, green, and
     blue, and possibly no bits of alpha.  It does not support stereo display.
     It may or may not have one or more auxiliary color buffers, a back
     buffer, a depth buffer, a stencil buffer, or an accumulation buffer.


NNNNOOOOTTTTEEEESSSS
     ggggllllXXXXCCCChhhhoooooooosssseeeeFFFFBBBBCCCCoooonnnnffffiiiiggggSSSSGGGGIIIIXXXX is part of the GGGGLLLLXXXX____SSSSGGGGIIIIXXXX____ffffbbbbccccoooonnnnffffiiiigggg extension.

     ggggllllXXXXCCCChhhhoooooooosssseeeeFFFFBBBBCCCCoooonnnnffffiiiiggggSSSSGGGGIIIIXXXX is implemented as a client-side utility; it does
     not require a round-trip to the X server.

     ggggllllXXXXCCCChhhhoooooooosssseeeeFFFFBBBBCCCCoooonnnnffffiiiiggggSSSSGGGGIIIIXXXX and ggggllllXXXXGGGGeeeettttFFFFBBBBCCCCoooonnnnffffiiiiggggAAAAttttttttrrrriiiibbbbSSSSGGGGIIIIXXXX can be used to
     implement selection algorithms other than the generic one implemented by
     ggggllllXXXXCCCChhhhoooooooosssseeeeFFFFBBBBCCCCoooonnnnffffiiiiggggSSSSGGGGIIIIXXXX. Call ggggllllXXXXCCCChhhhoooooooosssseeeeFFFFBBBBCCCCoooonnnnffffiiiiggggSSSSGGGGIIIIXXXX to retrieve all the
     frame buffer configurations on a particular screen or, alternatively, all
     the frame buffer configurations with a particular set of attributes. Next
     call ggggllllXXXXGGGGeeeettttFFFFBBBBCCCCoooonnnnffffiiiiggggAAAAttttttttrrrriiiibbbbSSSSGGGGIIIIXXXX to retrieve additional attributes for the
     frame buffer configurations and then select between them.

     GLX implementers are strongly discouraged, but not proscribed, from
     changing the selection algorithm used by ggggllllXXXXCCCChhhhoooooooosssseeeeFFFFBBBBCCCCoooonnnnffffiiiiggggSSSSGGGGIIIIXXXX.
     Therefore, selections may change from release to release of the client-
     side library.

     GGGGLLLLXXXX____SSSSAAAAMMMMPPPPLLLLEEEE____BBBBUUUUFFFFFFFFEEEERRRRSSSS____SSSSGGGGIIIISSSS and GGGGLLLLXXXX____SSSSAAAAMMMMPPPPLLLLEEEESSSS____SSSSGGGGIIIISSSS are not valid attributes
     unless the SSSSGGGGIIIISSSS____mmmmuuuullllttttiiiissssaaaammmmpppplllleeee extension is supported.

     GGGGLLLLXXXX____XXXX____VVVVIIIISSSSUUUUAAAALLLL____TTTTYYYYPPPPEEEE____EEEEXXXXTTTT, GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____TTTTYYYYPPPPEEEE____EEEEXXXXTTTT,
     GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____IIIINNNNDDDDEEEEXXXX____VVVVAAAALLLLUUUUEEEE____EEEEXXXXTTTT, GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____RRRREEEEDDDD____VVVVAAAALLLLUUUUEEEE____EEEEXXXXTTTT,
     GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____GGGGRRRREEEEEEEENNNN____VVVVAAAALLLLUUUUEEEE____EEEEXXXXTTTT, GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____BBBBLLLLUUUUEEEE____VVVVAAAALLLLUUUUEEEE____EEEEXXXXTTTT, and
     GGGGLLLLXXXX____TTTTRRRRAAAANNNNSSSSPPPPAAAARRRREEEENNNNTTTT____AAAALLLLPPPPHHHHAAAA____VVVVAAAALLLLUUUUEEEE____EEEEXXXXTTTT are not valid attributes unless the
     EEEEXXXXTTTT____vvvviiiissssuuuuaaaallll____iiiinnnnffffoooo extension is supported.

     GGGGLLLLXXXX____VVVVIIIISSSSUUUUAAAALLLL____CCCCAAAAVVVVEEEEAAAATTTT____EEEEXXXXTTTT is not a valid attribute unless the
     EEEEXXXXTTTT____vvvviiiissssuuuuaaaallll____rrrraaaattttiiiinnnngggg extension is supported.


EEEERRRRRRRROOOORRRRSSSS
     NNNNUUUULLLLLLLL is returned if an undefined GLX attribute is encountered in
     _a_t_t_r_i_b__l_i_s_t, if _s_c_r_e_e_n is invalid or if _d_p_y does not support the GLX
     extension.



                                                                        PPPPaaaaggggeeee 8888






ggggllllXXXXCCCChhhhoooooooosssseeeeFFFFBBBBCCCCoooonnnnffffiiiiggggSSSSGGGGIIIIXXXX((((3333GGGG))))   OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee ---- GGGGLLLLXXXX   ggggllllXXXXCCCChhhhoooooooosssseeeeFFFFBBBBCCCCoooonnnnffffiiiiggggSSSSGGGGIIIIXXXX((((3333GGGG))))



MMMMAAAACCCCHHHHIIIINNNNEEEE DDDDEEEEPPPPEEEENNNNDDDDEEEENNNNCCCCIIIIEEEESSSS
     The SSSSGGGGIIIISSSS____mmmmuuuullllttttiiiissssaaaammmmpppplllleeee extension is supported only on RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee,
     RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee2222, and VVVVTTTTXXXX systems and IIIInnnnffffiiiinnnniiiitttteeeeRRRReeeeaaaalllliiiittttyyyy systems.


SSSSEEEEEEEE AAAALLLLSSSSOOOO
     ggggllllXXXXGGGGeeeettttFFFFBBBBCCCCoooonnnnffffiiiiggggAAAAttttttttrrrriiiibbbbSSSSGGGGIIIIXXXX, ggggllllXXXXCCCCrrrreeeeaaaatttteeeeCCCCoooonnnntttteeeexxxxttttWWWWiiiitttthhhhCCCCoooonnnnffffiiiiggggSSSSGGGGIIIIXXXX,
     ggggllllXXXXCCCCrrrreeeeaaaatttteeeeGGGGLLLLXXXXPPPPiiiixxxxmmmmaaaappppWWWWiiiitttthhhhCCCCoooonnnnffffiiiiggggSSSSGGGGIIIIXXXX, ggggllllXXXXGGGGeeeettttVVVViiiissssuuuuaaaallllFFFFrrrroooommmmFFFFBBBBCCCCoooonnnnffffiiiiggggSSSSGGGGIIIIXXXX.















































                                                                        PPPPaaaaggggeeee 9999